home *** CD-ROM | disk | FTP | other *** search
/ PC World Interactive 1 / PC World Interactive 1 - Nisan 1997.iso / nostalji / bbs / graph / vesavw63.arj / VESAVIEW.DOC < prev    next >
Text File  |  1994-03-24  |  88KB  |  1,646 lines

  1. VESAVIEW.EXE   v 6.3  
  2.  
  3.  
  4. TABLE of CONTENTS:
  5.      
  6.      Keywords. . . . . . . . . . . . . . . . . . . . . . . . . .   3
  7.      
  8.      Brief Desc. . . . . . . . . . . . . . . . . . . . . . . . .   3
  9.      
  10.      LEGAL STUFF . . . . . . . . . . . . . . . . . . . . . . . .   3
  11.      
  12.      REGISTRATION. . . . . . . . . . . . . . . . . . . . . . . .   3
  13.      
  14.      DISCLAIMER. . . . . . . . . . . . . . . . . . . . . . . . .   4
  15.      
  16.      PROGRAM FILE LIST . . . . . . . . . . . . . . . . . . . . .   4
  17.      
  18.      REQUIREMENTS. . . . . . . . . . . . . . . . . . . . . . . .   5
  19.      
  20.      FEATURES. . . . . . . . . . . . . . . . . . . . . . . . . .   5
  21.      
  22.      INSTALLING PROGRAM. . . . . . . . . . . . . . . . . . . . .   6
  23.      
  24.      RUNNING PROGRAM and OPTIONS MENU. . . . . . . . . . . . . .   6
  25.      
  26.      SYSTEM DEFAULTS . . . . . . . . . . . . . . . . . . . . . .  12
  27.      
  28.      CHANGING DIRECTORY. . . . . . . . . . . . . . . . . . . . .  12
  29.      
  30.      VIEW SINGLE IMAGE (from Text directory) . . . . . . . . . .  13
  31.      
  32.      VIEW MULTIPLE IMAGES (slide show) (from
  33.                Text directory) . . . . . . . . . . . . . . . . .  13
  34.      
  35.      VIEW / CREATE AN ARRAY OF IMAGES (from Text
  36.                directory). . . . . . . . . . . . . . . . . . . .  13
  37.      
  38.      AUTO ARRAY GENERATION/SAVING. . . . . . . . . . . . . . . .  14
  39.      
  40.      VIEWING FILES (from a previously created
  41.                Array image). . . . . . . . . . . . . . . . . . .  14
  42.      
  43.      VIEWING GIF89A FILES - Special Case . . . . . . . . . . . .  15
  44.      
  45.      VIEWING HPG or PLT FILES. . . . . . . . . . . . . . . . . .  15
  46.      
  47.      VIEWING ASCII FILES . . . . . . . . . . . . . . . . . . . .  16
  48.      
  49.      DELETING FILES. . . . . . . . . . . . . . . . . . . . . . .  16
  50.      
  51.      RENAMING a FILE . . . . . . . . . . . . . . . . . . . . . .  16
  52.      
  53.      SEARCHING FILENAMES . . . . . . . . . . . . . . . . . . . .  16
  54.      
  55.      SPECIAL KEYS WHILE VIEWING. . . . . . . . . . . . . . . . .  16
  56.      
  57.      FILTERING IMAGE . . . . . . . . . . . . . . . . . . . . . .  17
  58.      
  59.      SAVING SCREEN AS a  BMP, GIF or PCX FILE. . . . . . . . . .  18
  60.      
  61.      SAVING SCREEN AS a JPG FILE . . . . . . . . . . . . . . . .  18
  62.      
  63.      CROPPING SCREEN & SAVING AS a  BMP, GIF,
  64.                JPG or PCX FILE . . . . . . . . . . . . . . . . .  18
  65.      
  66.      SCALING XMEM CONTENTS TO SCREEN & SAVING. . . . . . . . . .  19
  67.      
  68.      SAVING XMEM CONTENTS AS an IMG or PCX FILE. . . . . . . . .  19
  69.      
  70.      PRINTING IMAGES . . . . . . . . . . . . . . . . . . . . . .  19
  71.      
  72.      MOUSE USE . . . . . . . . . . . . . . . . . . . . . . . . .  20
  73.      
  74.      RUNNING Under WINDOWS 3.1 . . . . . . . . . . . . . . . . .  20
  75.      
  76.      CAUTIONS. . . . . . . . . . . . . . . . . . . . . . . . . .  21
  77.      
  78.      HINTS . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  79.      
  80.      CARDS TESTED. . . . . . . . . . . . . . . . . . . . . . . .  23
  81.      
  82.      SUPPORT . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  83.      
  84.      REVISION HISTORY. . . . . . . . . . . . . . . . . . . . . .  23
  85.      
  86.  
  87. VESAVIEW.EXE   v 6.3  
  88.  
  89. Keywords: VESA BMP EPS GIF IFF/LBM IMG JPG MAC PCX TGA TIF HPGL PRINT
  90.           CATALOG VIEWER DESKJET LASERJET PAINTJET BJC600
  91.  
  92. Brief Desc:    View and print BMP, EPS, GIF, IFF/LBM, IMG/GEM, JPG, MAC,
  93.                PCX, TGA & TIF images & HPGL plotter files.  Arrays of up
  94.                to 144 images/screen can be generated and saved for easy
  95.                cataloging.  HPGL plot files can be saved as B&W files. 
  96.                Mouse support.  Requires a VESA driver for your graphics
  97.                card and enough extended memory to hold entire image.  
  98.                Supports VESA modes thru 1280x1024x256.  Quick panning of
  99.                images larger than your screen resolution.
  100.                Color/brightness/contrast adjustments, scaling & cropping
  101.                of color images. Fade control for slide shows. 24 bit
  102.                color reduction for BMP, JPG, TGA & PCX. Excellent Black
  103.                & White printing to HP DeskJet, LaserJet or Epson Stylus 800. 
  104.                Superb Color printing to HP PaintJet, PaintJet XL,
  105.                PaintJet XL300, DeskJet 500C/550C and Canon BJC600. 
  106.                Images can be selected graphically from previously
  107.                created arrays.
  108.  
  109.  
  110.  
  111. LEGAL STUFF:   Copyright (c) William M. White 1992,1993,1994.
  112.                Compuserve ID: 71170,2340
  113.  
  114. The VESAVIEW product is Shareware. If you find it useful, please
  115. register your copy and tell your friends about it.  This product may not
  116. be sold or packaged, either individually, or as part of any other
  117. product without the express written consent of the author. This product
  118. may not be changed or altered and then distributed without the express
  119. written consent of the author.  The VESAVIEW.DOC & VESAVIEW.LGO files
  120. must accompany VESAVIEW.EXE whenever the non-registered version is
  121. distributed.
  122.  
  123. The JPEG decoding and encoding portion of this program "is based in part
  124. on the work of the Independent JPEG Group".  "The Graphics Interchange
  125. Format (c) is the Copyright property of CompuServe Incorporated.  GIF
  126. (sm) is a Service Mark property of CompuServe Incorporated."
  127.  
  128. REGISTRATION:
  129.  
  130. INDIVIDUAL USER:    $35.00 each
  131.  
  132. QUANTITY DISCOUNTS &/or SITE LICENSES FEES:
  133. (Includes one diskette with Program, Documentation and sample images)
  134.      1 - 9          copies  @ $35.00 each
  135.      10 - 24        copies  @ $31.00 each
  136.      25 - 49        copies  @ $27.00 each
  137.      50 - 99        copies  @ $23.00 each
  138.      100 - 249      copies  @ $19.00 each
  139.      250 - 500      copies  @ $15.00 each
  140.      500 +          copies or for use on CD-ROM - Call for pricing
  141.  
  142. Extra program diskettes are available at $6.00 each when purchasing
  143. multiple copies or site licenses.
  144.  
  145. When ordering in quantity,  you must supply the names and addresses of
  146. all users and a main contact person so that I can provide each of them a
  147. unique User Name and Access Code and can honor their technical support
  148. requests on an individual basis.  If you desire a Site License, the
  149. above pricing schedule still applies, but all copies will be registered
  150. to a single company (or corporation) name with a single access code, and
  151. all technical support would be through a single contact.  Please supply
  152. the company name and contact person for site licenses.
  153.  
  154. For foreign orders, please send a check drawn on a U.S. Bank,
  155. International or U.S. Postal Money Order, Travelers Checks or cash,
  156. since banks charge a sizable fee for foreign check processing.
  157.  
  158. For orders outside of the U.S. & Canada, please add $6.00 for shipping
  159. and handling.  
  160.  
  161.      Please send your  registration fee to:
  162.           William M. White
  163.           P. O. Box 2273
  164.           Glen Allen, VA. 23058-2273
  165.  
  166. By Registering your copy(s), you will receive an unhindered copy of the
  167. latest version of VESAVIEW on 3 1/2" HD floppy (unless you note
  168. otherwise), technical support by mail or BBS, and help support the
  169. continued development of the product.  You will also receive a personal
  170. User Access Code so that you can easily convert any new shareware
  171. versions from the following BBSs into your new registered copy, thus
  172. eliminating additional fees for update mailings.  Current shareware
  173. versions of the product will always be available on Compuserve in the
  174. GRAPHSUPPORT forum (GO PICS) and on the Blue Ridge Express Bulletin
  175. Board (804)-790-1675.  Replacement or upgrade disks will be available
  176. for $10.00 each to cover handling.  NOTE:  Your registered copy of the
  177. program produces a file named VESAVIEW.REG which should never be
  178. distributed since it will be encoded with your name and access code..
  179.  
  180. Non-hindered versions of VESAVIEW are available to incorporate on CD-
  181. ROMs. If the CD-ROM version is copied and not run from the original CD-
  182. ROM, it will revert back to a non-registered version.   Please contact
  183. the author at the above address for fees and more information. 
  184.  
  185. DISCLAIMER:
  186.  
  187. VESAVIEW is offered to you on an as-is-basis without any guarantee as to
  188. the correct functioning or fitness for a specific purpose.  The author
  189. believes this program to work as described but you use the program
  190. entirely at your own risk.  The author will not be responsible for any
  191. hardware or software damage, loss of data, or incidental or
  192. consequential damage that may result from its use, whether or not such
  193. use is in accordance with the instructions.
  194.  
  195.  
  196. PROGRAM FILE LIST:
  197.  
  198. The following files make up the shareware version of VESAVIEW which may
  199. be distributed to other BBSs or friends:
  200.  
  201.      VESAVIEW.EXE   - Main program
  202.      VESAVIEW.LGO   - Logo Screen for SVGA
  203.      VESAVIEW.LGX   - Logo Screen for VGA
  204.      VESAVIEW.ICO   - Icon for use when running from Windows 3.1 
  205.      VESAVIEW.DOC   - ASCII version of document file
  206.      VESAVIEW.WP    - WordPerfect v 5.1/5.2 version of document file
  207.      FILE_ID.DIZ    - Brief program description used by some
  208.                       bulletin boards
  209.  
  210. NOTE:     After running VESAVIEW for the first time, a personal access
  211.           file will be created named VESAVIEW.REG.  Please DO NOT
  212.           distribute this file.  If you select the 'SAVE CONFIGURATION'
  213.           item from the Options Menu, a file will be created named
  214.           VESAVIEW.CFG.
  215.  
  216. Occassionally, VESAVIEW needs to write out temporary files (includes the
  217. configuration file).  By default, these files are written to the same
  218. directory that the VESAVIEW program resides in.  If this drive and
  219. directory is not available for writing (as on CD-ROMs), VESAVIEW will
  220. use the Disk and Drive pointed to by the DOS environmental variable TEMP
  221. ( ex:  SET TEMP=C:\TMPFIL ) and if that environmental variable is
  222. missing it will use C:\ .
  223.  
  224. REQUIREMENTS:
  225.  
  226. o    IBM compatible 286 or better
  227. o    DOS version 3.0 or higher
  228. o    Extended memory (and driver such as HIMEM).  For 256 (& higher)
  229.      color files, you'll need 1 byte/pixel in your image.  For 2 color
  230.      files, you'll need 1 byte per 8 pixels in your image.  This program
  231.      conforms to XMS 2.0 specification.  8MB of extended memory is
  232.      recommended expecially if you will be using graphic array menus and
  233.      working with JPEG files.
  234. o    Will use a math coprocessor if available
  235. o    A graphics card that supports the VESA BIOS EXTENSIONS for the
  236.      'Super VGA modes' either through hardware or a software driver. 
  237.      NOTE: If no VESA driver is found, you will be limited to
  238.      320x200x256 or 640x480x2 non-VESA modes which won't allow arrays to
  239.      be generated.
  240.  
  241. FEATURES:
  242.  
  243. o    Will read in any size up to 1280 x 1024:
  244.  
  245.      BMP (Windows) -          16, 256 color & 24 bit (16 million colors)
  246.      EPS (Encapsu Postscript)-B & W (the TIFF previews embedded in
  247.                               the Postscript file)
  248.      GIF (Compuserve 87a/89a)-16 & 256 color (includes GIFs with
  249.                               MAC Headers)
  250.      IFF/LBM (Amiga/Deluxe Paint)- 2, 16 & 256 color
  251.      IMG (GEM/Digital Research) - B & W
  252.      MAC (MacPaint) -         2 color
  253.      JPG (JPEG/JFIF) -        Grayscale & 24 bit (16 million colors)
  254.      PCX (Zsoft) -            2, 16, 256 color & 24 bit (16 million
  255.                               colors)
  256.      TGA (Targa) -            8,16, 24 & 32 bit (non-compressed RGB &
  257.                               Run length encoded RGB)
  258.      TIF -                    B & W, 16c, 256c  & 24 bit
  259.                               (non-compressed, run length encoded and
  260.                               Huffman)
  261.      HPG -                    (Hewlett Packard) HPGL plot files (.HPG or
  262.                               .PLT)
  263.      TEXT -                   ASCII files with up to 2000 lines with
  264.                               extensions of .1ST, .ANS, .ASC, .ASM,
  265.                               .BAT, .BAK, .C, CONFIG.SYS, .DIZ, .DOC,
  266.                               .INI, .H, .LIS, .ME,  .TXT and .VNX.  
  267.  
  268. o    Files can be selected either from a text directory listing or
  269.      graphically from a previously created array of images (mouse
  270.      required for graphic selection).  Multiple selections are displayed
  271.      in the order selected.
  272.  
  273. o    If the file is larger than the screen mode you selected, you can
  274.      quickly pan around the image.  Size of image is limited only by the
  275.      amount of extended memory you have.  NOTE:  The entire image is
  276.      read into Extended memory to allow for quick panning of large
  277.      images.  Black & White images are stored in memory with 1 byte per
  278.      8 pixels. 16 (4 bit) and 256 color (8 bit) images are stored in
  279.      memory with 1 byte per pixel.  24 & 32 bit images are stored in
  280.      memory as 256 color images so only 1 byte per pixel is required.
  281.  
  282. o    Black & White printing (color images will be dithered) and Color
  283.      printing are supported.  Prints can be sized, rotated and
  284.      positioned on paper.  Printers supported are HP LaserJet Series,
  285.      DeskJets, DeskJet 500/500C/550C, PaintJet, PaintJet XL, PaintJet
  286.      XL300, Canon BJC600 and Epson Stylus 800.
  287.  
  288. o    Red/Blue/Green/Contrast/Brightness values may be changed while
  289.      viewing a color image.  Image can be converted to GrayTone or
  290.      colors reversed.
  291.  
  292. o    Filters are available to enhance image and include blurring
  293.      (smoothing), sharpening, edge detection and mosaic.
  294.  
  295. o    Color screen images can be saved as a 256 color BMP, GIF, JPG or
  296.      PCX file. These images may be cropped & scaled before saving.
  297.  
  298. o    Black & White images can be saved as an IMG or 2 color PCX file.
  299.      This is useful to save a HPGL file that is displayed on screen out
  300.      to a quicker retrieving raster file.  If these images are displayed
  301.      in a color VESA mode they can also be saved &/or cropped as 256
  302.      color  BMP, GIF, JPG or PCX files.
  303.  
  304. o    Arrays of up to 144 images can be displayed on a single screen at
  305.      once.  This screen can then be saved as a single  BMP, GIF, JPG or
  306.      PCX file for cataloging or printing or use as a graphic menu for
  307.      VESAVIEW.
  308.  
  309. o    Supports VESA modes (assuming your graphics card can handle):
  310.           100 -  640 x  400 x 256
  311.           101 -  640 x  480 x 256
  312.           103 -  800 x  600 x 256
  313.           105 - 1024 x  768 x 256
  314.           107 - 1280 x 1024 x 256
  315.  
  316. o    Will support a 800 x 600 x 2 color B&W mode if your card has one. 
  317.      (See /SVn option below)
  318.  
  319. o    Supports command line operation in addition to the menu driven
  320.      program
  321.  
  322. o    Supports the use of a MicroSoft compatible 2-button mouse.
  323.  
  324. NOTE:     The annoying beeps and NON-Registered notices will be removed
  325.           from registered copies.  Also, the NON-Registered version does
  326.           not support the new printing options (sizing, rotating and
  327.           positioning), nor the Compressing of printer data.
  328.  
  329. INSTALLING PROGRAM:
  330.  
  331. Create a directory on your HardDrive to hold the VESAVIEW program files. 
  332. Copy the zipped file you downloaded from a BBS or received on diskette
  333. into this directory.  The ZIP file is usually named VESAVWnn.ZIP where
  334. nn represents the version number.  Unzip it using PKUNZIP version 2.04g
  335. or higher (earlier versions will not work).  Set your default directory
  336. to the VESAVIEW directory you've created and type in VESAVIEW to run the
  337. program.  The first time you run it, you'll be asked to enter your
  338. registration information including User Name and Access Code.  This
  339. personal access information will be stored in a new file named
  340. VESAVIEW.REG in your VESAVIEW directory.  Please DO NOT distribute this
  341. file.  All files in the original zipped file may be distributed to your
  342. friends or other BBS as the Shareware version.  If you make a mistake
  343. keying in your User Name or Access Code, you will need to delete the
  344. VESAVIEW.REG file so you will be asked for them again.
  345.  
  346. RUNNING PROGRAM and OPTIONS MENU:
  347.  
  348. As of VESAVIEW version 6.0, most of the following command line
  349. qualifiers are available from the Options Menu within the program.  It
  350. is suggested that you use the Options Menu to configure the program and
  351. then save it with the 'Save Configuration' option rather than use
  352. command line qualifiers.  In future versions, some command line
  353. qualifiers may be discontinued.  If a configuration file is found when
  354. VESAVIEW starts up, it will be used by the program.  NOTE that if you
  355. also use command line qualifiers, they will override settings in the
  356. configuration file. 
  357.  
  358. Make sure you have enough extended memory available and that a driver
  359. (such as HIMEM) is loaded.  Make sure your graphics card has VESA BIOS
  360. EXTENSIONS (VBE) either built-in or that you have installed a VESA bios
  361. extensions (VBE) software driver.  Then just keyin:
  362.  
  363.      VESAVIEW  [filename or @filelist]  [optional qualifiers]
  364.  
  365. CAUTION:  DOS has a limitation of 127 characters on the command line. 
  366. If you exceed this when adding qualifiers, some may be truncated.
  367. NOTE: Underlined (or *) qualifiers are only available in the REGISTERED
  368. VERSION.  A 'space' is needed between each qualifier on the command
  369. line. 
  370.  
  371. filename =     The optional filename on command line is the name of a
  372.                single image file (without paths) in your current
  373.                directory.  If this option is used, the image will
  374.                display on screen without any of the usual screen
  375.                messages (or error messages).  If you also use the /R
  376.                qualifier, the image will be displayed using either the
  377.                currently saved delay factor or the delay value you
  378.                include with the /Dn qualifier (see slide delay below)
  379.                and then return to DOS or your calling batch file.  If
  380.                you don't use the /R qualifier, the image will be
  381.                displayed until the <ESC> key is pressed.  Wildcards
  382.                (*,?) are supported in the filename.  If a wild card is
  383.                used, the files will be sorted alphabetically.
  384.  
  385. @filelist =    This option is the name of a file which contains the
  386.                filenames (without paths) of images to display as a slide
  387.                show.  The file is an ascii file with the following
  388.                format and can be created with any ASCII text editor. 
  389.                Example:
  390.  
  391.           IMAGE01.GIF
  392.           IMAGE02.PCX
  393.           IMAGE03.BMP
  394.  
  395.           The filenames should begin in column one and should NOT
  396.           contain any paths, since you must be defaulted to the
  397.           directory where these files reside before starting VESAVIEW . 
  398.           The images will display in a continuous loop, delaying between
  399.           slides according to the Slide Delay (/Dn) and Fade value (/Fn)
  400.           qualifiers on your command line or the delay and fade values
  401.           previously saved in your configuration file.
  402.  
  403. [optional qualifiers]
  404.  
  405. The following qualifiers are available only when using a filename or
  406. @filelist from command line.  NOTE than when running VesaView from the
  407. command line, some of the warning and error messages are suppressed, so
  408. make sure your command line has the correct syntax):
  409.  
  410.      /R   (Return) - Used to return to DOS or your calling batch file
  411.           after displaying a single image which was supplied on your
  412.           command line.
  413.      /AP  (AutoPrint) - Used to automatically print your file(s) which
  414.           were supplied on your command line as a single image name or
  415.           the @filelist (see above).  Returns to DOS or your calling
  416.           batch file when complete.  Print width, rotation, style etc.
  417.           will be gotten from your last saved VESAVIEW.CFG file or can
  418.           be supplied as additional qualifiers on your command line.
  419.      
  420.      (The following 3 qualifiers can be used to auto-generate arrays
  421.      from the command line.  NOTE: All 3 must be used together.  The
  422.      preceding /AP qualifier can not be used with them.  )
  423.  
  424.      /AFx (Autoarray Filename) - x is the filename (1 - 6 characters, no
  425.           wildcards) that will be used when saving your array image(s). 
  426.           The program will append a 2 digit number to this filename in
  427.           case more than one page is required.   NOTE:  A disk and path
  428.           can be prefixed to the 1-6 character filename to force the
  429.           file to be written into a directory different from the images
  430.           (needed when using CDROM),  just as in the menu driven
  431.           program.  (Ex:  /AFC:\IMAGES\TEST ).  No checking is done for
  432.           existing duplicate filenames and they will be overwritten.
  433.  
  434.      /AEx (Autoarray Extension) - x is the extension (3 characters, no
  435.           wildcards) to use on the filename.  This can be GIF, BMP, PCX
  436.           or JPG.  This tells the program which type of file to create.
  437.  
  438.      /ADn (Autoarray Dimension) - n is a value from 2 to 12 which
  439.           indicates the dimensions of the array image.  (Ex.  /AD5 would
  440.           indicate a 5 x 5 matrix).
  441.  
  442.      AUTOARRAY Example (assumes you have 40 GIF images in your current
  443.                         directory) :
  444.  
  445.           VESAVIEW  /AW  /AM103  /AFTEST  /AEGIF  /AD5   *.GIF  would
  446.           generate 2 files.  The first would be named TEST01.GIF and
  447.           contain 25 images, the second would be named TEST02.GIF and
  448.           contain 15 images.  Both would be 5 x 5 matrixes with a white
  449.           background at 800 x 600 x 256 resolution (mode 103).
  450.      
  451. Printer Setup -->
  452.      Printer Adjustments -->
  453.           Width * :      (Input value) - The /PWn (print width) is used
  454.                          to specify a print width.  n is a decimal value
  455.                          from 0.0 to 10.5.  If you enter a number
  456.                          greater than 8.0, the print will automatically
  457.                          be rotated 90 degrees.  The print width
  458.                          represents the width that you want the
  459.                          horizontal image dimension as seen on your
  460.                          screen to be printed, no matter what rotation
  461.                          angle you use.
  462.  
  463.           Rotation * :   (Select angle from list) - The /PAn (print
  464.                          angle) is used to rotate your print on the
  465.                          printed page.  Values for n can be 0, 90, 180
  466.                          or 270.
  467.  
  468.           Top Margin * : (Input value) - The /PTMn (printer top margin)
  469.                          sets the number of inches from the current
  470.                          position of printhead that the image will start
  471.                          printing.  n is a decimal value ranging from
  472.                          the minimum value of your printer (see /FTMn
  473.                          below) to 10.0.  If set to 99, your image will
  474.                          be centered from top to bottom.
  475.  
  476.           Left Margin * :     (Input value) - The /PLMn (printer left
  477.                               margin) sets the number of inches from the
  478.                               left side of page that the image will
  479.                               start printing.  n is a decimal value from
  480.                               0.25 to 7.5.  If set to 99, your image
  481.                               will be centered from left to right.  The
  482.                               maximum printable width on all printers is
  483.                               8.0" (1/4" left & right margins).
  484.  
  485.           Resolution:    (Select from list) - The /PRn (printer
  486.                          resolution) is used to specify the resolution
  487.                          in dots per inch (dpi) of your active printer. 
  488.                          For the DeskJet/LaserJet series, n can be 75,
  489.                          150 or 300 (600 for LJ4).  For the PaintJet
  490.                          series (except XL300), it can be 90 or 180. 
  491.                          Defaults to highest resolution for selected
  492.                          printer except the LaserJet IV which defaults
  493.                          to 300dpi.
  494.  
  495.           Gamma Correction:   (Input value) - The /PGn (print gamma
  496.                               correction) option will allow you to
  497.                               adjust the gamma of your Black & White or
  498.                               Color print.  It only modifies your
  499.                               printout, not your screen image  Simply
  500.                               put, gamma correction will adjust the
  501.                               intensities of red, green & blue values
  502.                               logarithmically since the human eye's
  503.                               perception of color intensity is non-
  504.                               linear.  The gamma value (n) is a decimal
  505.                               value between 0.5 and 2.0.  If set to 0,
  506.                               no gamma correction will be performed.  If
  507.                               this qualifier is not used and a
  508.                               configuration file has not yet been saved
  509.                               out from the options menu, the gamma
  510.                               defaults to a value best suited for the
  511.                               printer type selected from the command
  512.                               line.  Using higher values will result in
  513.                               the darker colors in your image being
  514.                               printed lighter and the lighter ones
  515.                               remaining the same.  This gives a much
  516.                               more natural looking printout.  Suggested
  517.                               gamma values are:
  518.                               1.25 for DeskJet, PaintJet, PaintJet XL,
  519.                                    LaserJet
  520.                               1.50 for DeskJet 500C & 550C, PaintJet
  521.                                    XL300 and LaserJet IV at 600 dpi.
  522.  
  523.           Print Compression * :    (Yes or No) - The /PC (print
  524.                                    compress) option will force the
  525.                                    transfer of data from your computer
  526.                                    to the printer to be in a compressed
  527.                                    (encoded) format.  This will speed up
  528.                                    the transfer of data (especially for
  529.                                    serial or networked printers).  Time
  530.                                    savings will vary depending on the
  531.                                    type and size of plot.  In some
  532.                                    cases, you may find no time savings
  533.                                    overall since the printer has to
  534.                                    decompress the data, but your CPU
  535.                                    should be freed up from processing
  536.                                    sooner.  (default is no compress). 
  537.                                    The PaintJet and LaserJet II don't
  538.                                    support this type of data
  539.                                    compression.  If your printouts look
  540.                                    garbled, don't use this qualifier.
  541.  
  542.      Print Style -->     (Select from list) - The /PSx (print style)
  543.                          option allows you to select the style of
  544.                          printing for Black & White or Color prints.  It
  545.                          can be one of the following:  /PSBQ (B&W Square
  546.                          Halftone), /PSBD (B&W Diamond Halftone), /PSBV
  547.                          (B&W Vertical), /PSBH (B&W Horizontal), /PSBB
  548.                          (B&W Bayer), /PSBS (B&W Scatter), /PSCQ (Color
  549.                          Square Halftone), /PSCD (Color Diamond
  550.                          Halftone), /PSCV (Color Vertical), /PSCH (Color
  551.                          Horizontal), /PSCB (Color Bayer) or /PSCS
  552.                          (Color Scatter).  The Scatter styles will
  553.                          process slower than the other dithering types
  554.                          since it uses an error difusing algorithm,
  555.                          however, the Scatter styles will in most cases
  556.                          have much better detailing and quality.  Square
  557.                          Halftoning is the default.
  558.  
  559.  
  560.      Print Model -->     (Select model from list) - The /PTx (printer
  561.                          type) is used to select your printer.  It can
  562.                          be one of the following:  
  563.                             /PTDJ (HP DeskJet)
  564.                             /PTLJ (HP LaserJet II,III)
  565.                             /PTLJ4 (HP LaserJet IV)
  566.                             /PTPJ (HP PaintJet)
  567.                             /PTPJXL (HP PaintJet XL)
  568.                             /PTPJXL3 (HP PaintJet XL300)
  569.                             /PTDJC (HP DeskJet 500C)
  570.                             /PTDJ5C (HP DeskJet 550C)
  571.                             /PTBJC (Canon BJC600)
  572.                          The new HP 1200C will work if you select the XL300
  573.                          printer.  Note that the Canon BJC600 emulates
  574.                          the Epson LQ-2550.
  575.  
  576.      Printer Port -->    (LPT1:, LPT2: or File) - The /P1 or /P2 (port)
  577.                          designates which printer port to use for
  578.                          printing (LPT1 or LPT2).
  579.                The /PF option forces printer output to a file instead of
  580.                a port.  The file will be created in your current
  581.                directory with the same filename as your image file but
  582.                with an extension of  .VVP .  This option works with
  583.                multiple plots as well.  No checking for duplicate
  584.                filenames is done.  To plot the file(s), from DOS keyin:
  585.                     COPY/B  filename.VVP  LPT1:  
  586.                where filename could be a wildcard and LPT1: could be
  587.                LPT2:.  The /B instructs DOS to use a binary copy mode. 
  588.                NOTE that if your files reside on a non-writeable drive
  589.                (such as a CD-ROM), the /PF option will not be able to
  590.                write the print files to the current directory.  Try
  591.                copying files to another drive.
  592.      
  593.      Printer Pins -->    The /PPn (printer pins) command line qualifier
  594.                          (not available on options menu) will allow you
  595.                          to adjust the number of pins used when printing
  596.                          to a Canon BJC600 or Epson Stylus printers.  
  597.                          Values allowed for n can range from 16 to 48
  598.                          (48 is the default).  If you experience banding
  599.                          when printing to the BJC600 or Stylus, try reducing
  600.                          the number of pins used in the print head on each 
  601.                          pass (ex.  /PP32 or /pp16).  Sometimes this will
  602.                          lessen the effect of banding caused by diminished
  603.                          ink flow to one end of the printhead.
  604.  
  605.  
  606. Array Setup -->
  607.      Array Background:   (Black or White) - The /AB forces the array
  608.                          mode to use a black background and white text
  609.                          for the filenames in an array image.  
  610.                          /AW forces the array mode to use a white background
  611.                          and black text (saves black ink when printing).
  612.  
  613.      Show Image Sizes:   (Yes or No) - The /AS (array sizes) enables the
  614.                          display of image sizes above each image of an
  615.                          array.  The size will be displayed after the
  616.                          filename of each image only if it will fit. 
  617.                          Typically at a resolution of 1024x768, the
  618.                          sizes will fit on 6x6 arrays and below.  At
  619.                          800x600, the sizes will fit on 5x5 arrays and
  620.                          below.  At 640x480, the sizes will fit on 4x4
  621.                          arrays.  Each image is tested individually, so
  622.                          on a given array screen, some sizes may appear
  623.                          and some may not.  You will see the sizes
  624.                          displayed after all images on a page have been
  625.                          processed.
  626.  
  627.      Default Array Mode: (Select VESA mode from list) - The /AMmode
  628.                          (where mode is 100, 101, 103, 105 or 107) will
  629.                          let you default to a specific mode when
  630.                          creating arrays.  The program will default to
  631.                          mode 101 if this switch is not used.  Only use
  632.                          a mode number that your card can support!
  633.  
  634. Slide Setup -->
  635.      Delay Time:    (Input time in seconds) - The /Dn (delay) is for
  636.                     setting the delay in seconds to use between slides. 
  637.                     The n is an integer number from 1 to 999 and
  638.                     defaults to 5 seconds.  This time is approximate and
  639.                     will vary depending  on the size of the image being
  640.                     read in.  Pressing the <ESC> key or Right mouse
  641.                     button will abort the slide show.  Pressing any
  642.                     other key or the Left mouse button will skip to the
  643.                     next slide.  NOTE:  If you want your slides to
  644.                     remain on the screen until you press a key, use a
  645.                     high number (999) for the delay time.
  646.  
  647.      Fade Speed:    (Input number) - The /Fn (fade) option will fade in
  648.                     and out your images on screen when displaying them
  649.                     as a slide show.  The n can range from 0 to 10.  0
  650.                     is no fade, 1 is the fastest fade and 10 is the
  651.                     slowest fade.
  652.  
  653. Filename Mask -->   (Select file extension(s) from list to include) -
  654.                     The /Mx (mask for filenames) will allow you to
  655.                     include only certain file types in your directory
  656.                     listing.  It can be one of the following:   /MALL
  657.                     (all filenames), /MDIS (all displayable graphics
  658.                     files), /MBMP, /MGIF, /MIFF, /MIMG, /MJPG, /MLBM,
  659.                     /MMAC, /MPCX, /MTGA /MTIF.  Note:  Array index files
  660.                     (.VNX) are always accessible by the program, even if
  661.                     they are not being displayed in your directory
  662.                     listing.  Caution:  When you use this qualifier to
  663.                     eliminate the display of certain file types from
  664.                     your screen, and you display a previously created
  665.                     array image that includes file types that are not
  666.                     currently displaying, those files will not be found
  667.                     even though they are actually in the directory.
  668.                     (they will be flaged on screen with a red
  669.                     crosshatch)
  670.  
  671. HPGL Setup -->
  672.      HPGL line wts: (None, Half or Full) - The /WF (full weights)
  673.                     will display the weights as originally drawn.
  674.                     The /WH (weight half) is similar to /WN except that
  675.                     the weights of lines will be halved (divided by 2).
  676.                     The /WN (weight none) will not display weights of
  677.                     lines in an HPGL plot file if the SP (select pen)
  678.                     keyword was used when creating the plots.  This will
  679.                     greatly speed up the screen drawing if you don't
  680.                     need to look at or print the weights.  Some CAD
  681.                     programs which generate the plot files create
  682.                     weighted lines by simply drawing the lines multiple
  683.                     times in the plot file (each slightly offset) and
  684.                     not by using the SP (set pen) command.  The /WN &
  685.                     /WH switches will have no effect on this type of
  686.                     plot files.
  687.  
  688.      Default HPGL size:  (A, B or C size) - The /UPSA, /UPSB & /UPSC
  689.                          (unknown plot size) qualifiers will allow the
  690.                          user to specify a default plot size (A, B. or
  691.                          C) if the program that created the .PLT file
  692.                          did not include the HPGL cmd PS to signify what
  693.                          the Plot Size was.  If one of these qualifiers
  694.                          is not used, and the .PLT file doesn't have a
  695.                          PS cmd, VESAVIEW will default to a 'C' size
  696.                          plot.
  697.  
  698. Misc Setup -->
  699.      Use XMEM for array: (Yes or No) - The /NLAM (no load array into
  700.                          memory) will disable the automatic loading of
  701.                          the first graphic array menu into XMEM even if
  702.                          there is enough memory to do so.  The program
  703.                          by default will load the first array image that
  704.                          will be used as a graphic menu into XMEM, if
  705.                          there is enough memory to hold this array and
  706.                          one more image (both are assummed to be the
  707.                          maximum size of 1280x1024x256).  If you are low
  708.                          on XMEM and you wish to be able to pull up
  709.                          larger files (B&W for example) from the array
  710.                          menu, you will probably need to use this qualifier.
  711.  
  712.      Fixed Top Margin:   (Input value) - The /FTMn (fixed top margin)
  713.                          option will allow you to override the program's
  714.                          default values for that part on the top of a
  715.                          page that your printer can't print on.  The
  716.                          defaults for n are:
  717.                          0.1" -    DeskJet, DeskJet 500, DeskJet 500C
  718.                          0.05"-    DeskJet 550C
  719.                          0.0" -    LaserJet Series, PaintJet XL,
  720.                                    PaintJet XL300
  721.                          0.0" -    PaintJet (tractor feed)
  722.                          0.2" -    Canon BJC600, Epson Stylus 800
  723.  
  724.                     If your printed margins don't match what you set in
  725.                     the Printer Setup Menu, then use this qualifier to
  726.                     adjust them.
  727.  
  728.      Override VNX drive: (Yes or No)
  729.           Drive to use:  (Input drive letter or 0 for current drive ) -
  730.                          The /IDx (index drive override) option will
  731.                          allow you to override the drive that is
  732.                          embedded in the graphic menu index files
  733.                          (.VNX).  This is useful if you create graphic
  734.                          menus and their indexes on one drive and later
  735.                          move them to another drive.  x is the drive
  736.                          letter (A-Z) you want to use instead of the one
  737.                          in the index file, or make x = 0 to use the
  738.                          current drive you're on.  The other alternative
  739.                          to this qualifier is to actually edit the first
  740.                          line in the index file (.VNX) to reflect the
  741.                          new drive letter.
  742.  
  743.      Other B&W SVGA:     (Input mode number) - The /SVn (SVGA) will
  744.                          allow you to use a 800 x 600 x 2 color mode to
  745.                          display 2-color images or HPGL files in a high
  746.                          resolution mode if your graphics card supports
  747.                          it.  The n is the decimal mode number that your
  748.                          card uses for this mode.  Most Paradise cards
  749.                          use 41 decimal for this mode, and the Tseng
  750.                          cards (including Orchid) use 89 decimal.  This
  751.                          special mode and the standard 640 x 480 x 2
  752.                          mode will allow faster panning on screen than
  753.                          the same resolutions in VESA modes will for
  754.                          large B & W images. 
  755.  
  756.      Lockout VESA mode:  (Select mode(s) from list) - The /LOmode
  757.                          (lockout mode) (where mode is 100, 101, 103,
  758.                          105 or 107) will lock out a mode.  This is
  759.                          useful if your VESA driver is designed for a
  760.                          graphics card which has been fully populated
  761.                          with memory chips but your card doesn't have
  762.                          all of this memory installed.  You may use more
  763.                          than one of these switches on your command line.
  764.  
  765. B & W Foreground :  (Black, White or None) - The /FN, /FB or /FW specify
  766.                     the foreground color (N=none, B=Black and W=White)
  767.                     of your Black & White images.  By specified
  768.                     foreground color, the program will be able to save
  769.                     more of your image's original context when scaling
  770.                     down.  This qualifier works best if your images are
  771.                     line drawings and not pictures.  For example, if
  772.                     your image appears on the screen as black lines on a
  773.                     white background, use the /FB qualifier.  If your
  774.                     images don't have a main foreground color such as
  775.                     the case with pictures, use /FN. Note that using
  776.                     either the /FB or /FW qualifiers will increase the
  777.                     processing time for B&W scaling.  If you don't need
  778.                     the increased quality, use /FN.
  779.  
  780. 24 bit Palette :    (Standard, Optimize or Optimize and Dither) - The
  781.                     /CO (color-optimized) will force 16, 24 & 32 bit
  782.                     images to be processed using an optimized 256 color
  783.                     palette.  The process reads in all the colors in
  784.                     your image, creates a histogram of the most used
  785.                     colors, and then creates an optimized palette of the
  786.                     results. The processing time is greater than if the
  787.                     /CS option is used, but the results are spectacular. 
  788.                     The color reduction method used is much faster than
  789.                     that of other programs that  I have tested.  After
  790.                     the image has been displayed on the screen, you
  791.                     might want to save it as a 256 BMP, GIF, JPG or PCX
  792.                     file, so that the next time you want to display it,
  793.                     you can use the quicker 256 color version.
  794.  
  795.           The /COD (color-optimized & dithered) qualifier is similar to
  796.           /CO above, except that besides using an optimized palette, the
  797.           image will also be dithered to smooth out the transition
  798.           between colors.
  799.  
  800.           The /CS (color-standard) will force 16, 24 & 32 bit images to
  801.           be displayed using a standard palette.  The colors will be
  802.           adequate for previewing, but for more exact colors, use the
  803.           /CO.
  804.  
  805.  
  806. Beep after Display: (Yes or No) - The /NB (no beep) option will disable
  807.                     the beeps after images are displayed on screen.  The
  808.                     default is to beep.
  809.  
  810.  
  811. SYSTEM DEFAULTS:    /AB /AM101 /COD /D5 /F0 /FB /MALL /P1 /PTDJ
  812.                     /PW8.0 /PA0 /PTM0.25 /PLM0.25  /UPSC  /WF
  813.  
  814.      Ex:  VESAVIEW /P2 /AW /D10  - Will use printer port LPT2:, display
  815.      arrays with a white background, and delay 10 seconds between
  816.      slides.
  817.  
  818.      Ex:  VESAVIEW /LO105 /LO107 /AM103 - Will lockout modes 105 and 107
  819.      from being valid VESA modes and will use mode 103 when displaying
  820.      arrays.
  821.  
  822. The program will test to see if your graphics card supports the VESA
  823. Bios Extensions by either hardware or software driver, whether you have
  824. a HIMEM driver loaded and how much extended memory you have available.
  825.  
  826. Use the <ESC> or <X> key to exit program or click on EXIT option on
  827. bottom of screen with left mouse button.
  828.  
  829. CHANGING DIRECTORY:
  830.  
  831. While the list of files is on your screen, you can change your current
  832. directory by placing the cursor on the lite blue entries (which are
  833. directory names) and pressing <ENTER>.  The . (single dot) will take you
  834. back to the root directory, and the .. (double dots) will take you back
  835. one directory level.  Selecting a yellow Disk Drive entry will change
  836. your disk drive.
  837.  
  838. You can also press the <C> key (or click on CDIR with mouse) to keyin a
  839. new path that can include a new disk drive. (Ex: B: or B:\ or C:\GIF or
  840. C:\IMAGES\GIF or \GIF or \GIF\).  NOTE that the program tolerates
  841. trailing backslashes.
  842.  
  843. VIEW SINGLE IMAGE (from Text directory):
  844.  
  845. To view a single image move the cursor (with arrows, pageup, pagedown,
  846. home or end keys) to the desired image file and press <ENTER>.  Then
  847. select a Vesa Mode from the Mode Menu. An asterisk denotes the Best Mode
  848. (calculated by the program) which will display the most of your entire
  849. image on a single screen in the best resolution.  After your image is
  850. displayed, press <ESC> (or right mouse button) to return to main menu. 
  851. Note that when viewing IMG files or HPGL files, you can use a VESA mode
  852. (only B&W colors used), use the standard 640 x 480 x 2 mode or use the
  853. Super VGA mode that you optionally entered on the command line.  Entries
  854. in gray on the Mode Menu are not available for your graphics card.  See
  855. the 'Special Keys while Viewing' section below for available viewing
  856. options.
  857.  
  858. VIEW MULTIPLE IMAGES (slide show) (from Text directory):
  859.  
  860. To view multiple images as a 'slide show', use the <Space Bar> (or right
  861. mouse button) to select the images you wish to view.  You can mark all
  862. images in the current directory with the <M> key (or click on MARK with
  863. mouse) or unmark them with the <U> key (or UNMARK with mouse).  These
  864. can include any displayable image or plot files, but no ASCII text
  865. files.  By pressing the <C> key, you can change your current Disk &/or
  866. Directory.  Press <ENTER> (or left mouse button) to start the slide
  867. show.  The files will be displayed one by one in the best VESA mode as
  868. determined by the program (640x480x2 mode is used for PLT & HPG files). 
  869. The delay between slides will vary depending on the time it takes to
  870. read in the next file while one is on your screen and the value used in
  871. the  /Dn switch.  Fading in and out between multiple images can be done
  872. by using the /Fn switch.  After the last file is displayed, the program
  873. will loop back to first slide.  Pressing <ESC> (or right mouse button)
  874. during the display will stop the slide show. (this may take several
  875. seconds).  Note:  Files will be displayed  in the order in which they
  876. were selected.  You can pause the slide show by pressing the <Pause> key
  877. on keyboard.  Any other key will continue the show.
  878.  
  879. VIEW / CREATE AN ARRAY OF IMAGES (from Text directory):
  880.  
  881. To view multiple images on a single screen at once, use the <Space Bar>
  882. (or right mouse button) to select the images you wish to view.  These
  883. cannot include PLT or HPG files.  Press <A> (or click on ARRAY with
  884. mouse) to select array display.  Select the VESA mode from Mode Menu and
  885. then select the number of images to display per screen page. Then sit
  886. back and watch your images appear.  Pressing <ESC> (or right mouse
  887. button) will  abort the display after the current image is displayed. 
  888. After each page is displayed, you could press <B> to save the currently
  889. displayed page as a Windows BMP file, <G> for GIF file, <J> for JPG or
  890. <Z> for ZSoft PCX file or <PAGE DN> will continue to display the next
  891. page.
  892.  
  893. If you used the /AS qualifier or selected 'Show Array Sizes' from the
  894. Options Menu, the image sizes will be displayed alongside the filenames.
  895.  
  896. Since each image uses it own unique 256 colors, a special optimized
  897. color table and color dithering is used to display arrays.  Note that
  898. when displaying a 2-color file in an array, the scaling down of the
  899. original image (especially a line type drawing) will cause much of the
  900. info to be lost on the screen unless the /FB or /FW command qualifier is
  901. used.
  902.  
  903. Creating arrays of your images is a good method of saving a sequence of
  904. images for a slide show.  They are saved in the array in the order you
  905. selected them.  To play them back, just pull up that array image, press
  906. 'M' to mark all images, and press left mouse button to display them.
  907.  
  908. WARNING:  Files with more than 81 (9 x 9) images per page should not be
  909. viewed with versions of VESAVIEW prior to version 5.0 since a system
  910. hangup could occur because of internal array variable overflow!
  911.  
  912. NOTE:  Arrays are only available in VESA modes.  Files will be arranged
  913. in the array in the order in which they were selected.
  914.  
  915. AUTO ARRAY GENERATION/SAVING:
  916.  
  917. If you are going to have many pages (screens) of array images and you
  918. will be saving them all out as single files, you can do this
  919. automatically by the <G> (or click on AUTO/GEN with mouse) to activate
  920. the generate option.  This will automatically display the arrays on the
  921. screen and then save them out without any user intervention until the
  922. last one is processed.  You begin just as you would for the standard
  923. array option by selecting the files to display, the VESA mode, and then
  924. the number of images/page. You are first prompted for the file type to
  925. use when saving.  Then you are prompted for the first 1-6 characters of
  926. the filename that the program will use for the files it generates.  You
  927. may precede the filename with a Disk & Directory if you don't want to
  928. use the current Disk/Dir.    The system will append a 2 digit page
  929. number and appropriate extension to your input.
  930.  
  931. EX:  You are going to have 3 pages of array images and you select <G>IF
  932. as the filetype and  enter TEST as the filename.  The System will
  933. generate 3 files named TEST01.GIF, TEST02.GIF & TEST03.GIF.
  934.  
  935. VIEWING FILES (from a previously created Array image):
  936.  
  937. If you have previously created and saved an array of images, you can use
  938. it to graphically select the images you want to display either
  939. singularly or as a slide show or for plotting.  NOTE: A mouse is
  940. required for this mode.  Just select the array image from the Text
  941. directory listing.  After it is displayed, use the box shaped cursor to
  942. select the files.  The left mouse button will select one file and
  943. display it immediately.  The right mouse button is used to Mark/Unmark
  944. files for a slide show or multiple plotting. Files are outlined with a
  945. red box when they are marked.  If a file on your array menu does not
  946. exist in your current any more, the file will be cross-hatched with red
  947. lines.   After all files you desire are marked, press the left mouse
  948. button to start the display.  The /Dn and /Fn (delay and fade) work with
  949. multiple selections from arrays.  Files will be displayed in the order
  950. that they were selected on the screen.  If you want to display all of
  951. the files in the same order they were created, just press <M> to mark
  952. them all, and press the left mouse button to start the show.  NOTE:
  953. Normally a right mouse button is used to Quit the current image, but
  954. since that button is used to Mark/Unmark files in the array menu, you
  955. must simultaneously press both the left and right button to Quit.  You
  956. can still use the <ESC> key to quit.
  957.  
  958. Array images created before VESAVIEW version 4.0 will not allow graphic
  959. file selection.  Version 4.0 and above creates an additional index file
  960. for each array image you create.  This file will have the same filename
  961. as your array image but with an extension of  .VNX .  If this files does
  962. not exist in the same directory as your array image file, you will not
  963. be able to use the array image as a graphic menu, but you can still view
  964. it as a normal image.  The index file is very small, and unlike other
  965. graphic packages which allow graphical selection of images from the
  966. screen, VESAVIEW does not require separate THUMBNAIL files for each
  967. image which saves considerable time and disk space.  As of version 4.3,
  968. the array image together with its index file may be stored (or saved) on
  969. a Disk/Directory that is different from the location of the images in
  970. the array.  This will allow users to catalog images from CDROMs (which
  971. can't be written to) etc.  VESAVIEW assumes that if your array images
  972. have nested arrays, all of these arrays are located in the same
  973. directory, but each of the array's images can be located on different
  974. Disk/Directories if needed.  The index file stores the Disk & Directory
  975. of the images in the array.  NOTE:  If you ever move your images from
  976. where the array was initially created, you will either need to re-
  977. catalog them or use a text editor to change the path (first entry) in
  978. the .VNX file.  To make the index file downward compatable with versions
  979. prior to 4.3, the program will accept index files that didn't store the
  980. images path in them as the first entry.
  981.  
  982. Up to six levels of array menus can be used (nested).  For example, you
  983. could have one array image that had other array images in it.  One idea
  984. would be to have individual array images for BMPs, GIFs, JPGs, PCXs and
  985. TGAs.  Then have a master array image which would include the BMP, GIF,
  986. JPG, PCX  and TGA arrays.  While an array image is displayed, selecting
  987. another array image from it will pull up that new array menu and so on. 
  988. If you have displayed an image out of a sub-level array menu, the <ESC>
  989. or right mouse button will return you to the previously displayed array
  990. menu. (remember that if you are displaying an array file, you must use
  991. both the left and right mouse button together to return to previous
  992. image).
  993.  
  994. If you need to add or delete an image from the array image, you will
  995. need to re-create it.  New array images can only be created from the
  996. Text directory listing.
  997.  
  998. Additional Keys available while displaying an array image:  
  999.  
  1000.      M1 (left mouse button)   Used to start displaying a single or
  1001.                               marked multiple images
  1002.      M2 (right mouse button)  Used to Mark or Unmark files
  1003.      M1 & M2 (together)       Used to Quit from an array image
  1004.  
  1005. (See 'SPECIAL KEYS WHILE VIEWING'  later for standard keys available)
  1006.      
  1007. Warning: You cannot have different array files with the same filename
  1008. and different extensions in the same directory since each file will use
  1009. the extension .VNX for its index file.   Ex:  You cannot have DIR01.GIF
  1010. and DIR01.BMP array files in the same directory since the program would
  1011. not know which one the index file DIR01.VNX should be associated with.
  1012.  
  1013.  
  1014. VIEWING GIF89A FILES - Special Case:
  1015.  
  1016. If you are viewing a single GIF89A file, most of the 89A extensions will
  1017. be processed including multiple images, plain text and control blocks. 
  1018. Comments will not be displayed.  Because of the way VESAVIEW reads
  1019. images into Extended memory before displaying them, the plain text will
  1020. only be displayed on the screen (not XMEM).  This will prevent the
  1021. printing of the text since printing is done from what is in Extended
  1022. memory.  One way around this, if your screen has enough resolution to
  1023. display the entire file, is to save your screen out to another file with
  1024. <G> and then pull up that file and print it.  NOTE, that the save
  1025. commands will only save out what is on the screen after all of the 89A
  1026. extensions are processed.  If the extensions include delays between
  1027. images, or require the user to <press> a key, the program will continue
  1028. after 15 seconds maximum so that slide shows will not be put in a wait
  1029. state looking for user input.  
  1030.  
  1031. If you are viewing arrays which include GIF89A files, the extensions
  1032. will be processed entirely in XMEM before displaying them in the array. 
  1033. No text extensions will be displayed (they would probably be too small
  1034. to read anyway).  Delays between GIF89A extensions are not processed
  1035. when displaying array images for increased speed.
  1036.  
  1037. VIEWING HPG or PLT FILES:
  1038.  
  1039. To view a plot file created in a HPGL format, move the cursor to the
  1040. filename and press <ENTER>.  Then choose the Display Mode and Plot Mode
  1041. you wish to use.  The program will try and determine the size of plot
  1042. from the plot file header, but some CADD packages don't supply this info
  1043. in which case the program will assume a "C size".  The HPGL codes for
  1044. Plot Sizes are:
  1045.  
  1046.      PS4 = 'A' size
  1047.      PS0 = 'B' size
  1048.      PS1 = 'C' size
  1049.  
  1050. Choosing a display mode of FIT, 2X or 4X will speed up the drawing
  1051. process but the resolution of the image will be diminished. As the image
  1052. is decoded, you will see it being drawn in a preview mode at screen
  1053. size.  After the image is complete, pressing any key will swap you to
  1054. the actual image as stored in Extended memory for panning around in. 
  1055. Pressing <ESC> (or right mouse button) as the image is being decoded
  1056. will abort it.
  1057.  
  1058. Currently supported HPGL commands are:  PU,PD,PA,PR,PS,IP,SC,SP, CI and
  1059. AA
  1060.  
  1061. Even though the LB,SI,SR,DF,DI & DR commands are parsed and used to
  1062. display the image on the initial preview screen, they are not supported
  1063. as the drawing is being created in Extended memory. This won't usually
  1064. pose a problem since this program was designed to view HPGL files
  1065. created by CADD programs and most of those programs represent Text etc.
  1066. as vector elements.
  1067.  
  1068. WARNING:  Only plot files which were created as C size or smaller should
  1069. be viewed, since the program does no checking for elements which could
  1070. be drawn 'off' the page if too big.  This check was omitted to speed up
  1071. the drawing.
  1072.  
  1073. VIEWING ASCII FILES:
  1074.  
  1075. To view a single ASCII file on your screen, just select it as with any
  1076. other filetype.  The file will be displayed in a text window.  The
  1077. following file extensions are recognized as ASCII files -  .1ST, .ANS,
  1078. .ASC, .ASM, .BAK, .BAT, .C, CONFIG.SYS, .DIZ, .DOC, .H, .INI, .LIS, .ME, 
  1079. .TXT and .VNX.  You may use the following keys while viewing an ASCII
  1080. file:
  1081.      Pan Up a Line       - UP ARROW or RIGHT MOUSE BUTTON
  1082.      Pan Down a Line     - DOWN ARROW or LEFT MOUSE BUTTON
  1083.      Pan Up a Page       - PAGE UP
  1084.      Pan Down a Page     - PAGE DN
  1085.      Abort               - ESC or Both LEFT & RIGHT MOUSE BUTTONS
  1086.                            simultaneously
  1087.  
  1088. NOTE:  ASCII files cannot be viewed from a graphics menu or in a slide
  1089. show.  Only the first 2000 lines of a file will be displayable.  The
  1090. entire file is not stored in memory but accessed from the disk drive as
  1091. needed.
  1092.  
  1093. DELETING FILES:
  1094.  
  1095. While the file list is displayed on your screen, you may delete a file
  1096. by moving the cursor to it, marking it with <spacebar> and pressing
  1097. <DEL> or <D>  on the keyboard.  To delete multiple files, mark them with
  1098. the <spacebar> (or right mouse button) and then press <DEL>.  You will
  1099. be asked to confirm each deletion.
  1100.  
  1101. RENAMING a FILE:
  1102.  
  1103. While the file list is displayed on your screen, you may rename a single
  1104. by moving the cursor to it, marking it with <spacebar> and pressing <R>
  1105. on the keyboard.  You cannot select more than one file at a time for
  1106. renaming.
  1107.  
  1108. SEARCHING FILENAMES:
  1109.  
  1110. While the file list is displayed on your screen, you may select files by
  1111. searching their filenames for a specific string.  Press <S> (or click on
  1112. SEARCH with mouse) and keyin the search string.  The file will be
  1113. selected if it contains the exact string anywhere in its filename. 
  1114. Don't use the wildcard characters * or ? since they will be searched for
  1115. literally.
  1116.  
  1117. SPECIAL KEYS WHILE VIEWING:
  1118.  
  1119. While viewing images in a VESA mode (other than arrays):
  1120.  
  1121.      F1/F2     Decrease/Increase RED
  1122.      F3/F4     Decrease/Increase GREEN
  1123.      F5/F6     Decrease/Increase BLUE
  1124.      F7/F8     Decrease/Increase CONTRAST
  1125.      F9/F10    Decrease/Increase BRIGHTNESS
  1126.      ALT F8    Inverse Colors (Negate)
  1127.      ALT F9    Change to Gray tones
  1128.      ALT F10   Restore original palette
  1129.      B         Create a BMP file (256 c) of screen contents
  1130.      C         Crop an image and save as  BMP, GIF, JPG or PCX file
  1131.      F         Filter the screen image with different functions
  1132.      G         Create a GIF file (256 c) of screen contents
  1133.      H or ?    Graphics Help
  1134.      J         Create a JPG file (24 bit) of screen contents
  1135.      O         Display Options Menu
  1136.      P         Send XMEM contents to printer as B&W or Color image
  1137.      S         Scale XMEM contents to screen and save as BMP, GIF, JPG
  1138.                or PCX file
  1139.      V         Display the current VGA palette
  1140.      Z         Create a PCX file (256 c) of screen contents
  1141.      +         Zoom in (change VESA resolution to next lower mode)
  1142.      -         Zoom out (change VESA resolution to next higher mode)
  1143.           NOTE: Mode 100 (640x400) is skipped when using +/- above.
  1144.  
  1145. See the 'FILTERING IMAGE' section below for use of the 'F' option.
  1146.  
  1147. While viewing an array (one about to be saved, not a previously saved
  1148. one):
  1149.  
  1150.      B    Create a BMP file (256 c) of screen contents
  1151.      C    Crop an image and create a  BMP, GIF, JPG or PCX file
  1152.      G    Create a GIF file (256 c) of screen contents
  1153.      J    Create a JPG file (24 bit) of screen contents
  1154.      Z    Create a PCX file (256 c) of screen contents
  1155.  
  1156. While viewing IMG or HPGL files in a B & W mode:
  1157.  
  1158.      P    Send XMEM contents to printer as B&W image
  1159.      I    Create an IMG file (2 c) of entire XMEM contents.  The 'I'
  1160.           option may also be used if you are viewing an IMG or HPGL file
  1161.           in a color VESA mode.
  1162.      Z    Create a PCX (2 c) file of entire XMEM contents.
  1163.  
  1164. In both Color and B & W modes you may pan screen with:
  1165.     (make sure the NUMLOCK key is on to use keypad)
  1166.  
  1167.      HOME      Top left of image
  1168.      END       Bottom right of image
  1169.      Page Up   Move up approx. 1 inch
  1170.      Page Dn   Move down approx. 1 inch
  1171.      ESC       Return to File Selection Menu
  1172.  
  1173. The arrow keys on either numeric keypad or separate arrow keypad pan the
  1174. image approx. 1/4 inch in that direction. In addition, on the numeric
  1175. keypad, the 1,3,7 & 9 keys pan the image diagonally and the 5 pans to
  1176. center of image.
  1177.  
  1178. Use the Control key with left or right arrows to pan 1 inch to the left
  1179. or right.
  1180.  
  1181. FILTERING IMAGE:
  1182.  
  1183. The FILTER option (<F> key) will prompt you for the type of filter you
  1184. desire.  It will be <B>lur (smooth), <S>harpen, <E>dge detection or
  1185. <M>osaic .  It only affects the screen image (not image as stored in
  1186. extended memory), so when you pan or do a new window area on screen the
  1187. filtering will be cleared.  After you have filtered the screen, you may
  1188. save that screen image as usual with the appropriate keyin.  The Filter
  1189. options are not recommended on 2-color files.  Filters operations are
  1190. accumulative.  You may keep applying the same or different filters to
  1191. the image to get more intense and sometimes very spectacular results. 
  1192. For instance, try applying a mosaic filter, then use the sharpening
  1193. filter.  The quality of the filtering operations are dependent on the
  1194. '24 BIT PALETTE' setting on the Options Menu.  For quicker (and less
  1195. accurate) filtering, use the Standard option.  For more accurate results
  1196. (but longer processing time), use the Optimized or Optimized & Dithered
  1197. option which will calculate a new palette for your filtered image. 
  1198. NOTE:  After you have filtered an image, you must save the image and
  1199. pull up the saved image in order to print it.
  1200.  
  1201. SAVING SCREEN AS a  BMP, GIF or PCX FILE:
  1202.  
  1203. While viewing an image in a VESA mode, pressing <B> will save the
  1204. current screen (not necessarily everything in Extended memory) to a BMP
  1205. file with the filename of your choosing.  Pressing <G> will save to a
  1206. GIF file.  Pressing <Z> will save to a PCX file.  The dimensions will
  1207. come from the mode you are currently viewing the image in or the cropped
  1208. size that you used.  The color table written to file will reflect any
  1209. adjustments you've made with the Function keys.  When keying in the
  1210. filename, if you don't include the period or extension, the program will
  1211. append the correct extension to your keyin.  If you keyin the extension
  1212. with your filename, the program will use that instead, but make sure you
  1213. keyin the appropriate extension since the extension is how the program
  1214. determines the file type to display!  You may precede the filename with
  1215. a Disk & Directory if you don't want to use the current Disk/Dir.
  1216.  
  1217. SAVING SCREEN AS a JPG FILE:
  1218.  
  1219. JPEG is a standardized compression method for full-color (24 bit) and
  1220. grayscale images.  JPEG is a lossy type of compression, meaning that the
  1221. output image is not necessarily identical to the input image.  This
  1222. software implements JPEG baseline and extended-sequential compression
  1223. processes and the file format used is called JFIF.  This format has been
  1224. agreed to by a number of major commercial JPEG vendors and probably will
  1225. become the de facto standard.  Some commercial JPEG implementations are
  1226. incompatible, especially if they were written before the summer of 1991. 
  1227. Some other shareware JPEG program's output will only work if they have
  1228. the option of outputing as JFIF standard files.
  1229.  
  1230. The procedure for saving the current screen to a JPG file is the same as
  1231. for saving to a GIF, BMP or PCX (see above section), except that an
  1232. extra question is asked after you key in the filename.   You will need
  1233. to enter a JPEG quality factor ranging from 25 to 95.  The default if
  1234. you just press <CR> is 75.  A higher quality factor will result in
  1235. larger files and less loss of image quality.   A lower quality factor
  1236. will result in smaller files with more loss of image quality.  
  1237.  
  1238. It is not recommended to save array images as JPG files if they will be
  1239. used as graphic menus, since they will take considerably longer to
  1240. decode.
  1241.  
  1242. NOTE:  Most error messages from the JPEG compression/decompression
  1243. routines are due to corrupt or non-supported features in your JPEG file. 
  1244. However, the most common error will be 'Insufficient memory case ?'
  1245. which usually means that you have insufficient low memory (RAM in the 0-
  1246. 640K range).  Try and eliminate any non-crucial drivers &/or TSRs loaded
  1247. into low memory.  For saving or reading in 1024x768 JPEGs, you'll
  1248. probably need 200K or more free RAM.  The amount of free RAM can be
  1249. found by using the VESA/MEMORY option under the HELP menu.
  1250.  
  1251. CROPPING SCREEN & SAVING AS a  BMP, GIF, JPG or PCX FILE:
  1252.  
  1253. If you press <C> you will be able to crop your screen image before
  1254. saving as a BMP, GIF, JPG or PCX file.  You will see a box drawn around
  1255. your screen image when you first press <C>.  Press a <T> to move the
  1256. TopLeft corner of box.  Press <B> to move the BottomRight corner. Use
  1257. the arrow keys to move a single pixel at a time, or PageUp, PageDown,
  1258. <CTRL>Leftarrow or <CTRL>Rightarrow to move 10 pixels at a time.  <HOME>
  1259. will move the Topleft corner of box to Topleft of screen.  <END> will
  1260. move the Bottomright corner of box to Bottomright of screen.  <ESC> will
  1261. abort and a <CR> will start the screen save. You will be prompted
  1262. whether to save as a BMP, GIF, JPG or PCX file.  See 'Using a Mouse'
  1263. below.
  1264.  
  1265. SCALING XMEM CONTENTS TO SCREEN & SAVING:
  1266.  
  1267. If you press <S> you will be able to scale the entire image in XMEM to
  1268. your screen.  You will see a box drawn around your screen when you first
  1269. press <S>.  If you just press the <CR> key at this time, your entire
  1270. image will be fitted to your screen at the current VESA resolution.  Use
  1271. the arrow keys etc. (like in cropping above) to move the lower right
  1272. corner of box.  Scaling always occurs about the upper left corner of
  1273. image, so you can't move this point. <ESC> will abort and a <CR> will
  1274. start the screen save.  See 'Using Mouse' below.
  1275.  
  1276. SAVING XMEM CONTENTS AS an IMG or PCX FILE:
  1277.  
  1278. While viewing a 2 color Black/White image (either IMG, 2-color PCX or
  1279. HPGL files), pressing an <I> will save the entire eXtended memory
  1280. contents to a IMG file, or pressing <Z> will save as a 2-color PCX file. 
  1281. You will have the opportunity to reverse the image before saving.  It
  1282. doesn't matter whether you are viewing the image in a color VESA mode or
  1283. one of the Black & White modes in order to save with the <I> mode, as
  1284. long as the original image was actually a 2 color image.  Currently,
  1285. there is not a cropping option before saving as a IMG file.  However, if
  1286. you are viewing the 2-color image in a color VESA mode, you could save
  1287. out as a cropped BMP, GIF, JPG or PCX file.
  1288.  
  1289. PRINTING IMAGES:
  1290.  
  1291. Before displaying an image that you will be printing, you should pull up
  1292. the Printer Setup Menu and Printer Model Menu (submenus of OPTS menu)
  1293. and make any necessary changes to model, style, size, margins, rotation
  1294. and gamma etc.  After an image is displayed, any adjustments to
  1295. color/brightness/contrast will be reflected in your print.  The gamma
  1296. value (see description of /PGn qualifier above) is a good tool to use if
  1297. adjustment to brightness is needed for printouts.  The maximum size of
  1298. image is limited only by the amount of free XMEM you have.  The maximum
  1299. size of print is 10.5 x 8.0 inches on most printers.  On the DeskJet
  1300. 550C printer, note that you can't print on the bottom 1/2" of page, so
  1301. if you are centering your print, the maximum length can't be greater
  1302. than 10.0", but if you set your Top Margin to the minimum of 0.05", you
  1303. can squeeze in about 10.4".
  1304.  
  1305. If you want to print multiple images, select them from the file list
  1306. with the <Space Bar> (or right mouse button) as for slides, and then
  1307. press <P> (or click on PLOT with mouse).  Each file will be displayed on
  1308. screen and automatically plotted until the last one is processed.  NOTE
  1309. that all of the plots will use the same size, rotation, justification
  1310. etc. from the plotting options menu.  Pressing <ESC> (or right mouse
  1311. button) will abort the plotting.  NOTE:  This option is only available
  1312. in Registered Versions.
  1313.  
  1314. To print more than one copy of the same image, it is suggested that you
  1315. change the Port Option to File (See /PF above under Printer Options). 
  1316. This will save your print in a file that you can just copy to your
  1317. printer from DOS (must use COPY / B )  as many times as you like, thus
  1318. saving re-processing time for each copy.
  1319.  
  1320. While a color image file is displayed on the screen, pressing <P> will
  1321. create a print on your active printer in the current print style.  The
  1322. scatter style will produce a better quality print in most cases, but
  1323. will take longer then the other styles to process.  You may cancel the
  1324. plot by pressing <ESC> (or right mouse button) during the plot. The port
  1325. defaults to LPT1 unless you specified a command line argument of /P2 or
  1326. /PF when starting the program or selected another one from the Options
  1327. Menu.  The actual plot will be of your entire image (stored in extended
  1328. memory) and not just what you may be viewing on your screen.
  1329.  
  1330. While viewing a 2-color (black & white) file or HPGL (.PLT or .HPG),
  1331. pressing <P> will create a Black & White print.  
  1332.  
  1333. See description of /FB, /FW & /FN above to preserve B & W image context
  1334. when your print is being scaled down from the original size.  You can
  1335. use any of the printer qualifiers (available as command line qualifiers
  1336. or from the Printer Menu within program) to change the defaults for
  1337. Printer Port, Printer Type, Resolution, Rotation Angle, Width and Top &
  1338. Left Margins.  
  1339.  
  1340. If you select a Print Width greater than 8.5", the program will
  1341. automatically rotate print 90 degrees (unless 270 was already selected). 
  1342. The program will beep if you try to use an invalid combination of size,
  1343. rotation angle, margins or resolution.
  1344.  
  1345. MOUSE USE:
  1346.  
  1347. In most cases where the keypad is used to move the text cursor, a
  1348. MicroSoft compatible mouse can also be used.  You must install any
  1349. required mouse drivers before running VESAVIEW.
  1350.  
  1351. The Left button is used just like the <CR> key on the keyboard to
  1352. display one image. It is also used to select choices from pop-up menus,
  1353. to select commands at the bottom of screen and to select the PageUp and
  1354. PageDown icons from the vertical bar on the right side of screen.
  1355.  
  1356. The Right button is used just like the <ESC> key on the keyboard to
  1357. abort displays and menus.  It is also used to mark files for use in
  1358. arrays or for displaying them as slides (like the <spacebar>).
  1359.  
  1360. If a large image has been displayed in one of the 256 color VESA modes,
  1361. holding down the Left mouse button will display a panning icon on your
  1362. screen.  The green box represents your entire image size and the red box
  1363. represents your screen size.  While holding down the Left button, move
  1364. the mouse and the red box will pan around with the green box.  When you
  1365. let go of the button, the screen with be moved to reflect your new
  1366. window area.  This mode of panning is much quicker than using the arrow
  1367. keys, although you will probably use the arrow keys for fine tuning the
  1368. pan.  If a double-beep is heard when trying to use this feature, your
  1369. image is probably smaller than your screen and no panning is possible.
  1370.  
  1371. When Cropping an image, the Left mouse button will move the upper left
  1372. corner of the cropping box and the Right mouse button will move the
  1373. lower right corner of box.  Pressing both the Left and Right buttons
  1374. simultaneously will start the save (like pressing <CR>).  Scaling works
  1375. the same except the Left mouse button is not used (can't move the upper
  1376. left corner of scaling box).
  1377.  
  1378. RUNNING Under WINDOWS 3.1:
  1379.  
  1380. VESAVIEW can be run in a Full Screen mode from Windows 3.1.  Because of
  1381. the way Windows 3.1 allocates memory, it is suggested that you use a 
  1382. .PIF file to run VESAVIEW.  The following are recommended settings for
  1383. the PIF file when running under Windows:
  1384.      
  1385.      Program Item Properties
  1386.      Description:   VesaView       
  1387.      Command Line:  VESAVIEW.PIF   
  1388.      Working Directory:  C:\GIF    <-- Path of initial image directory
  1389.      Shortcut Key:       None           
  1390.  
  1391.      (NOTE:  You can use the ICON that is delivered with VESAVIEW or
  1392.      your own.  The supplied icon is in the file VESAVIEW.ICO.)
  1393.  
  1394. Use the following for 386 ENHANCED MODE -
  1395.      PIF EDITOR - VESAVIEW.PIF
  1396.      Program Filename:   C:\VV\VESAVIEW.EXE    <-- Path of VESAVIEW.EXE
  1397.      Window Title:       VesaView
  1398.      Optional Parameters: /AW /AM103 /PTDJ /AS <-- Modify these as needed
  1399.      Start-up Directory:           
  1400.      Video Memory:       _  Text        _  Low Graphics     X  High
  1401. Graphics
  1402.      Memory Requiremts:  KB Required    -1   KB Desired  -1
  1403.      EMS Memory:         KB Required    0    KB Limit  1024
  1404.      XMS Memory:         KB Required    1024 KB Limit    -1
  1405.      Display Usage: X  Full Screen      Execution:     _  Background
  1406.                     _  Windowed                        X  Exclusive
  1407.      X  Close Window on Exit
  1408.  
  1409.      PIF EDITOR - Advanced Options
  1410.  
  1411.      Background Priority:     50   Foreground Priority:     100
  1412.                     X  Detect Idle Time
  1413.      Memory Options:
  1414.           _  EMS Memory Locked          X  XMS Memory Locked
  1415.           _  Uses High Memory Area      X  Lock Application Memory
  1416.      Display Options:
  1417.           X  Text        _  Low Graphics          X  High Graphics
  1418.           X  Emulate Text Mode     X  Retain Video Memory
  1419.      Other Options: (leave as default)
  1420.  
  1421. Use the following for STANDARD MODE -
  1422.      PIF EDITOR - VESAVIEW.PIF
  1423.      Program Filename:   C:\VV\VESAVIEW.EXE    <-- Path of VESAVIEW.EXE
  1424.      Window Title:       VesaView  
  1425.      Optional Parameters: /AW /AM103 /PTDJ /AS <-- Modify these as needed
  1426.      Start-up Directory:                
  1427.      Video Memory:       _  Text        X Graphics/Multiple Text
  1428.      Memory Requiremts:  KB Required      -1
  1429.      XMS Memory:         KB Required    1024 KB Limit  -1
  1430.      Direct Modifiers:   _ COM1    _ COM3    _ Keyboard
  1431.                          _ COM2    _ COM4
  1432.      _ No Screen Exchange               _ Prevent Program Switch
  1433.      X  Close Window on Exit            _ No Save Screen
  1434.  
  1435.           
  1436. CAUTIONS:
  1437.  
  1438. The array used to store the files in current directory is limited to 999
  1439. files.  More files than this will just be truncated from directory
  1440. listing.
  1441.  
  1442. The program determines the type of file to display by the extension used
  1443. on the filename.  See 'Features Section' for supported extensions.  Any
  1444. other extensions are ignored.  Incorrect extensions may cause program to
  1445. hang  (ie. Don't name a PCX file with a GIF extension).
  1446.  
  1447. Even though your VESA driver thinks it supports some of the higher
  1448. resolution modes, your hardware may not have the required memory to do
  1449. so.  Therefore, you need to lockout these modes from the program with
  1450. the /LOmode command line switch.  If you don't lock out these modes, the
  1451. program may hang and you'll have to do the 3 finger trick (<CTRL> <ALT>
  1452. <DEL>).
  1453.  
  1454. When printing, make sure your printer is online before pressing the <P>
  1455. key, otherwise the printer may lose some of the data or lock up the
  1456. program.
  1457.  
  1458. Most error messages are self explanatory, but occasionally you might get
  1459. a misleading message.  Most errors of this nature will be caused by
  1460. corrupt image files.  Try pulling up the same image with another viewer
  1461. to see if you have similar problems.
  1462.  
  1463. HINTS:
  1464.  
  1465. When creating arrays of images that include 24 bit files, you may want
  1466. to toggle the 24 bit palette option to STANDARD to speed up the
  1467. processing. The color detail will not be too apparent at this small
  1468. scale.
  1469.  
  1470. Besides using the '@FILELIST command line option to play a slide show,
  1471. try the following:  To create and save a slide show sequence, just
  1472. create an array image and save it.  The images on the array will be
  1473. arranged in the order in which they were selected originally.  All you
  1474. need to do to play the slide show is pull up that array image, press 'M'
  1475. to mark all files, and then press the left mouse button to start the
  1476. show.  You should set the delay and fade before pulling up the array if
  1477. desired.
  1478.  
  1479. It is suggested that you prefix your array filenames with a 0 (zero) so
  1480. that they will be alphabetized at the beginning of the directory listing
  1481. for easier location. (Ex.  0DIR01.GIF, 0DIR02.GIF  etc).
  1482.  
  1483. If you will be using your array images as graphic menus for file
  1484. selection, a lower resolution array image will update on the screen
  1485. faster.  Even if you have just a few images to catalog, by placing them
  1486. in a larger format array image (ie. You have only 9 images to catalog
  1487. but create a 6 x 6 array image), the screen will be able to recall this
  1488. array as a menu much faster than creating it in a 3 x 3 array image. 
  1489. This is due to the greater compression of large areas of blank space on
  1490. the screen.
  1491.  
  1492. If you don't have a mouse, the graphic arrays you create can't be used
  1493. graphic menus.  You will need to manually delete the .VNX file for the
  1494. array file so that the system will think the array file is just an
  1495. ordinary image.
  1496.  
  1497. If you are using a printer supported by the DOS GRAPHICS command, you
  1498. can get a quick print of a Black & White screen by using the GRAPHICS
  1499. command before running VESAVIEW.  Version 5.0 of DOS supports the
  1500. DeskJet & LaserJets and the syntax would be:
  1501.      GRAPHICS DESKJET /r     (the /r will reverse black & white)
  1502.  
  1503.      Use <SHIFT><PRT SCRN> while graphics are on the screen to initiate
  1504.      the print.
  1505.  
  1506. If your printouts are too dark and you need to lighten them up, try
  1507. increasing the Gamma value instead of the brightness.  This will lighten
  1508. up the lower intensities and leave the higher intensities as they are. 
  1509. Raising the gamma value (to 1.5) will probably be necessary if you are
  1510. using the 600dpi mode of the LaserJet IV since the close dot spacing
  1511. will tend to darken the printout.
  1512.  
  1513. If you are using the Canon BJC600 or Epson Stylus 800 printers and you
  1514. experience banding, try using the command line qualifier /PPn
  1515. (see description above).
  1516.  
  1517. Besides using the SCALE option, there is a trick you can use to scale
  1518. down an image by 1/2,1/3,1/4...1/9.  Mark just one image and display it
  1519. as an array.  Select the Array Size according to the scale factor you
  1520. wish to use. (The color table used to display a single image as an array
  1521. will be the true color table of that image and not the standard
  1522. palette).  After the image is displayed, use the CROP feature to save
  1523. the area you desire as a color image.  Note that when a single array
  1524. image is displayed, the background color and text colors will change
  1525. according to the color table of the single image being displayed.
  1526.  
  1527. If you need a VESA driver for your graphics card, login to Compuserve
  1528. and go to the IBMPRO forum (GO VESA).  In Lib #12 (Vesa), you will find
  1529. VESA drivers for almost any card.
  1530.  
  1531. If you are not sure what graphics card you have in your machine, there
  1532. is a great little program in the GRAPHSUPPORT forum on Compuserve (GO
  1533. PICS).  In Lib #14 (Misc Util & Code) download VDEOID.EXE.  This program
  1534. will try and determine the card manufacturer & memory on it.
  1535.  
  1536. CARDS TESTED:
  1537.  
  1538. This program has been tested on the following computers and graphics
  1539. cards:
  1540.  
  1541. DELL 325D - Using built-in Paradise card
  1542. DELL 325D - Using a CompuAdd Hi-rez card
  1543. DELL 433D - Using Trident 8900 card
  1544. DELL 433P - Using built-in Paradise card
  1545. DELL 433P - Using a Video-7 VRAM II card
  1546. DELL 486D/50 - Using built-in Paradise card
  1547. DELL 486D/66 - Using built-in Paradise card & ATI Ultra card
  1548. NEC 386SX - Using a CompuAdd Hi-rez card
  1549. AST 286/386 Premium - Using Orchid Designer Pro card
  1550. AST 286/386 Premium - Using Diamond Stealth card (has built in VESA Bios
  1551.                       on card)
  1552. IBM 286 AT - Using a Paradise VGA Plus
  1553. IBM 286 AT - Using an ATI Wonder card & ATI Vantage
  1554. GATEWAY 2000 486/33 - Using an ATI Ultra card
  1555. GATEWAY 2000 4DX2-66V - Using an ATI Ultra XLR-2M card
  1556. DEC PC 486 - Using built-in graphics card
  1557.  
  1558. SUPPORT:
  1559.  
  1560. If you have any comments, suggestions or questions, please leave me a
  1561. message in the GRAPHSUPPORT forum (GO PICS) on Compuserve. My CIS ID
  1562. number is 71170,2340.  The current shareware version of VESAVIEW will
  1563. always be posted in the LIB #3 (Decoders & Encoders) of the GRAPHSUPPORT
  1564. forum on Compuserve.  It can also be found on the Blue Ridge Express
  1565. Bulletin Board (804)-790-1675.  The Zipped archival of VESAVIEW will
  1566. usually be named  VESAVW.ZIP or VESAVWxx.ZIP where xx is the version
  1567. number.  If you can't find it by filename, try searching for the
  1568. keywords VESA and HPGL.  You can also reach me at the P. O. Box listed
  1569. in the Registration section.
  1570.  
  1571. REVISION HISTORY:
  1572.  
  1573. 1.0 - 1.9      Developmental versions
  1574. 2.0 -4.9       Changes for these versions have been removed from this
  1575.                document to save space.
  1576. 5.0 (9/9/93)   Added ability to create an array image (menu) of up to 12
  1577.                x 12 images (144 total) per page if the resolution you
  1578.                select is high enough for the filenames to display above
  1579.                images.  Added check for free diskspace when auto-
  1580.                generating arrays.  Fixed bug when displaying long JPEG
  1581.                error messages which cause system hangups.  Made keyin
  1582.                field larger for filename of auto-generated arrays. 
  1583.                Directory listing now returns as it was bracketed on the
  1584.                screen after viewing images etc. instead of resetting to
  1585.                display file number 1.  New qualifier  /IDx  to override
  1586.                the embedded drive letter in index (.VNX) files. 
  1587.                Trailing backslashes when entering a new path are now
  1588.                tolerated.  Removed now unnecessary qualifiers /PYS and
  1589.                /PXS.  Added new registration procedure using a
  1590.                username/access code combination.
  1591. 5.1 (9/20/93)  Added several new Text File types which can be displayed
  1592.                (.BAK, CONFIG.SYS, .INI).  Slides can now remain on
  1593.                screen until a key is pressed to skip to next slide.  
  1594.                Saving an image from screen will now default to use the
  1595.                original image size if it less then screen dimensions
  1596.                versus always using the screen dimensions.  (This could
  1597.                only be done by cropping in previous versions.)  Fixed a
  1598.                bug which caused some RAM memory to be used and not freed
  1599.                up when reading/saving GIF files.
  1600. 5.2 (9/24/93)  Added the reading of .IFF/.LBM (Amiga/Deluxe Paint) and
  1601.                .MAC (MacPaint) files.  Added a smoothing, sharpening,
  1602.                edge detection and mosaic  filters option when in
  1603.                graphics ( 'F' key). Also added an Inverse Colors option
  1604.                (ALT F8) while in graphics.
  1605. 5.3 (10/4/93)  Options menu is now available while viewing a graphics
  1606.                image ('O' key).  Filters have been enhanced to use an
  1607.                optimized palette if desired by selecting the appropriate
  1608.                item on the Options Menu.  Added a file Rename option
  1609.                ('R' key).
  1610. 5.4 (10/14/93) Added 8 new printer styles. (NOTE that qualifier /PSBH &
  1611.                /PSCH now have different meanings. See the qualifier
  1612.                section of document).  Fixed bug which caused printing
  1613.                B&W halftones on certain PCs to hangup.
  1614. 5.5 (10/28/93) Added the reading of .EPS (the TIFF preview embedded in
  1615.                Encapsulated Postscript files).  Revised directory scans
  1616.                to speed up processing large directories while using
  1617.                graphics menus.  VESAVIEW can now be used by registered
  1618.                CD-ROM manufacturers as an unhindered version on their
  1619.                CD-ROMs.
  1620. 5.6 (11/09/93) Fixed VESA mode 107h (1280x1024x256) code to correct
  1621.                palette register settings.
  1622. 5.7 (11/19/93) Fixed a bug which erroneously showed 'Invalid TIF file
  1623.                format'  when displaying any TIF file.
  1624. 5.8 (11/22/93) Added support for 600dpi resolution of LaserJet IV and
  1625.                new printer type qualifier added (/PTLJ4).
  1626. 6.0 (12/1/93)  Added support for a list file of images (@FILENAME.LIS)
  1627.                or a single image filename to be supplied to the program
  1628.                from command line. All previous command line qualifiers
  1629.                are now available from the Options Menu.  A 'Save
  1630.                Configuration' option was added on Options Menu.  This is
  1631.                an easier way to save a setup rather than use the command
  1632.                line qualifiers. Fixed a minor problem with the /FTM
  1633.                qualifier if using LaserJet 4.  Added more error checking
  1634.                to prevent hangups with corrupt image files.
  1635. 6.1 (12/12/93) Added ability to automatically print file(s) supplied on
  1636.                command line by using the /AP qualifier.
  1637. 6.2 (1/20/94)  Added ability to automatically create array files from
  1638.                the command line with the new /AF, /AE and /AD
  1639.                qualifiers.  Text (ASCII) files are now allowed in array
  1640.                images.  Wildcards are now supported in the filename
  1641.                supplied to VESAVIEW from the command line.
  1642. 6.3 (3/22/94)  Added printer support for the Canon BJC600 color printer 
  1643.                and the Epson Stylus 800 black & white priner.  Added
  1644.                support for TIF Huffman decoding.   Added support for GIF
  1645.                files which have a MAC Header embeded in them. 
  1646.